package com.xy.webadmin.app.controller;

import cn.dev33.satoken.annotation.SaCheckPermission;
import cn.hutool.core.collection.CollUtil;
import cn.hutool.core.util.ReflectUtil;
import com.xy.common.core.upload.BaseUpDownloader;
import com.xy.common.core.upload.UpDownloaderFactory;
import com.xy.common.core.upload.UploadResponseInfo;
import com.xy.common.core.upload.UploadStoreInfo;
import com.xy.common.log.annotation.OperationLog;
import com.xy.common.log.model.constant.SysOperationLogType;
import com.github.pagehelper.page.PageMethod;
import com.xy.webadmin.app.vo.*;
import com.xy.webadmin.app.dto.*;
import com.xy.webadmin.app.model.*;
import com.xy.webadmin.app.service.*;
import com.xy.common.core.object.*;
import com.xy.common.core.util.*;
import com.xy.common.core.constant.*;
import com.xy.common.core.annotation.MyRequestBody;
import com.xy.common.redis.cache.SessionCacheHelper;
import com.xy.webadmin.config.ApplicationConfig;
import com.github.xiaoymin.knife4j.annotations.ApiOperationSupport;
import io.swagger.v3.oas.annotations.tags.Tag;
import lombok.extern.slf4j.Slf4j;
import org.springdoc.core.annotations.ParameterObject;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;
import org.springframework.web.multipart.MultipartFile;

import jakarta.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.util.*;
import java.util.stream.Collectors;

/**
 * 学生操作控制器类。
 *
 * @author xiaoyue
 * @date 2025-05-13
 */
@Tag(name = "学生管理接口")
@Slf4j
@RestController
@RequestMapping("/admin/app/student")
public class StudentController {

    @Autowired
    private GuardianService guardianService;
    @Autowired
    private ClazzService clazzService;
    @Autowired
    private ApplicationConfig appConfig;
    @Autowired
    private SessionCacheHelper cacheHelper;
    @Autowired
    private UpDownloaderFactory upDownloaderFactory;
    @Autowired
    private StudentService studentService;

    /**
     * 新增学生数据。
     *
     * @param studentDto 新增对象。
     * @return 应答结果对象，包含新增对象主键Id。
     */
    @ApiOperationSupport(ignoreParameters = {"studentDto.id"})
    @SaCheckPermission("student.add")
    @OperationLog(type = SysOperationLogType.ADD)
    @PostMapping("/add")
    public ResponseResult<Long> add(@MyRequestBody StudentDto studentDto) {
        String errorMessage = MyCommonUtil.getModelValidationError(studentDto, false);
        if (errorMessage != null) {
            return ResponseResult.error(ErrorCodeEnum.DATA_VALIDATED_FAILED, errorMessage);
        }
        Student student = MyModelUtil.copyTo(studentDto, Student.class);
        // 验证关联Id的数据合法性
        CallResult callResult = studentService.verifyRelatedData(student, null);
        if (!callResult.isSuccess()) {
            return ResponseResult.errorFrom(callResult);
        }
        student = studentService.saveNew(student);
        return ResponseResult.success(student.getId());
    }

    /**
     * 更新学生数据。
     *
     * @param studentDto 更新对象。
     * @return 应答结果对象。
     */
    @SaCheckPermission("student.update")
    @OperationLog(type = SysOperationLogType.UPDATE)
    @PostMapping("/update")
    public ResponseResult<Void> update(@MyRequestBody StudentDto studentDto) {
        String errorMessage = MyCommonUtil.getModelValidationError(studentDto, true);
        if (errorMessage != null) {
            return ResponseResult.error(ErrorCodeEnum.DATA_VALIDATED_FAILED, errorMessage);
        }
        Student student = MyModelUtil.copyTo(studentDto, Student.class);
        Student originalStudent = studentService.getById(student.getId());
        if (originalStudent == null) {
            // NOTE: 修改下面方括号中的话述
            errorMessage = "数据验证失败，当前 [数据] 并不存在，请刷新后重试！";
            return ResponseResult.error(ErrorCodeEnum.DATA_NOT_EXIST, errorMessage);
        }
        // 验证关联Id的数据合法性
        CallResult callResult = studentService.verifyRelatedData(student, originalStudent);
        if (!callResult.isSuccess()) {
            return ResponseResult.errorFrom(callResult);
        }
        if (!studentService.update(student, originalStudent)) {
            return ResponseResult.error(ErrorCodeEnum.DATA_NOT_EXIST);
        }
        return ResponseResult.success();
    }

    /**
     * 删除学生数据。
     *
     * @param id 删除对象主键Id。
     * @return 应答结果对象。
     */
    @SaCheckPermission("student.delete")
    @OperationLog(type = SysOperationLogType.DELETE)
    @PostMapping("/delete")
    public ResponseResult<Void> delete(@MyRequestBody Long id) {
        if (MyCommonUtil.existBlankArgument(id)) {
            return ResponseResult.error(ErrorCodeEnum.ARGUMENT_NULL_EXIST);
        }
        return this.doDelete(id);
    }

    /**
     * 批量删除学生数据。
     *
     * @param idList 待删除对象的主键Id列表。
     * @return 应答结果对象。
     */
    @SaCheckPermission("student.delete")
    @OperationLog(type = SysOperationLogType.DELETE_BATCH)
    @PostMapping("/deleteBatch")
    public ResponseResult<Void> deleteBatch(@MyRequestBody List<Long> idList) {
        if (MyCommonUtil.existBlankArgument(idList)) {
            return ResponseResult.error(ErrorCodeEnum.ARGUMENT_NULL_EXIST);
        }
        for (Long id : idList) {
            ResponseResult<Void> responseResult = this.doDelete(id);
            if (!responseResult.isSuccess()) {
                return responseResult;
            }
        }
        return ResponseResult.success();
    }

    /**
     * 列出符合过滤条件的学生列表。
     *
     * @param studentDtoFilter 过滤对象。
     * @param orderParam 排序参数。
     * @param pageParam 分页参数。
     * @return 应答结果对象，包含查询结果集。
     */
    @SaCheckPermission("student.view")
    @PostMapping("/list")
    public ResponseResult<MyPageData<StudentVo>> list(
            @MyRequestBody StudentDto studentDtoFilter,
            @MyRequestBody MyOrderParam orderParam,
            @MyRequestBody MyPageParam pageParam) {
        if (pageParam != null) {
            PageMethod.startPage(pageParam.getPageNum(), pageParam.getPageSize(), pageParam.getCount());
        }
        Student studentFilter = MyModelUtil.copyTo(studentDtoFilter, Student.class);
        String orderBy = MyOrderParam.buildOrderBy(orderParam, Student.class);
        List<Student> studentList = studentService.getStudentListWithRelation(studentFilter, orderBy);
        return ResponseResult.success(MyPageUtil.makeResponseData(studentList, StudentVo.class));
    }

    /**
     * 导入主表数据列表。
     *
     * @param importFile 上传的文件，目前仅仅支持xlsx和xls两种格式。
     * @return 应答结果对象。
     */
    @SaCheckPermission("student.import")
    @OperationLog(type = SysOperationLogType.IMPORT)
    @PostMapping("/import")
    public ResponseResult<Void> importBatch(
            @RequestParam Boolean skipHeader,
            @RequestParam("importFile") MultipartFile importFile) throws IOException {
        String filename = ImportUtil.saveImportFile(appConfig.getUploadFileBaseDir(), null, importFile);
        // 这里可以指定需要忽略导入的字段集合。如创建时间、创建人、更新时间、更新人、主键Id和逻辑删除，
        // 以及一些存在缺省值且无需导入的字段。其中主键字段和逻辑删除字段不需要在这里设置，批量插入逻辑会自动处理的。
        Set<String> ignoreFieldSet = new HashSet<>();
        ignoreFieldSet.add("createTime");
        ignoreFieldSet.add("updateTime");
        ignoreFieldSet.add("createUserId");
        ignoreFieldSet.add("updateUserId");
        List<ImportUtil.ImportHeaderInfo> headerInfoList = ImportUtil.makeHeaderInfoList(Student.class, ignoreFieldSet);
        // 下面是导入时需要注意的地方，如果我们缺省生成的代码，与实际情况存在差异，请手动修改。
        // 1. 头信息数据字段，我们只是根据当前的主表实体对象生成了缺省数组，开发者可根据实际情况，对headerInfoList进行修改。
        ImportUtil.ImportHeaderInfo[] headerInfos = headerInfoList.toArray(new ImportUtil.ImportHeaderInfo[]{});
        // 2. 这里需要根据实际情况决定，导入文件中第一行是否为中文头信息，如果是可以跳过。这里我们默认为true。
        // 这里根据自己的实际需求，为doImport的最后一个参数，传递需要进行字典转换的字段集合。
        // 注意，集合中包含需要翻译的Java字段名，如: gradeId。
        Set<String> translatedDictFieldSet = new HashSet<>();
        translatedDictFieldSet.add("isGoHomeAtNoon");
        translatedDictFieldSet.add("companyId");
        translatedDictFieldSet.add("sysUserId");
        List<Student> dataList =
                ImportUtil.doImport(headerInfos, skipHeader, filename, Student.class, translatedDictFieldSet);
        CallResult result = studentService.verifyImportList(dataList, translatedDictFieldSet);
        if (!result.isSuccess()) {
            // result中返回了具体的验证失败对象，如果需要返回更加详细的错误，可根据实际情况手动修改。
            return ResponseResult.errorFrom(result);
        }
        //TODO: 下面方法的第二个字段列表参数，用于判断导入的数据在数据表是否已经存在，存在则更新，否则插入，如全部新数据，则无需任何修改。
        studentService.saveNewOrUpdateBatch(dataList, CollUtil.newArrayList(), -1);
        return ResponseResult.success();
    }

    /**
     * 导出符合过滤条件的学生列表。
     *
     * @param studentDtoFilter 过滤对象。
     * @param orderParam 排序参数。
     * @throws IOException 文件读写失败。
     */
    @SaCheckPermission("student.export")
    @OperationLog(type = SysOperationLogType.EXPORT, saveResponse = false)
    @PostMapping("/export")
    public void export(
            @MyRequestBody StudentDto studentDtoFilter,
            @MyRequestBody MyOrderParam orderParam) throws IOException {
        Student studentFilter = MyModelUtil.copyTo(studentDtoFilter, Student.class);
        String orderBy = MyOrderParam.buildOrderBy(orderParam, Student.class);
        List<Student> resultList =
                studentService.getStudentListWithRelation(studentFilter, orderBy);
        // 导出文件的标题数组
        // NOTE: 下面的代码中仅仅导出了主表数据，主表聚合计算数据和主表关联字典的数据。
        // 一对一从表数据的导出，可根据需要自行添加。如：headerMap.put("slaveFieldName.xxxField", "标题名称")
        Map<String, String> headerMap = new LinkedHashMap<>(14);
        headerMap.put("id", "主键");
        headerMap.put("name", "学生名称");
        headerMap.put("number", "学生编号");
        headerMap.put("idCard", "身份证");
        headerMap.put("photo", "照片");
        headerMap.put("isGoHomeAtNoonDictMap.name", "是否留宿");
        headerMap.put("createTime", "创建时间");
        headerMap.put("updateTime", "更新时间");
        headerMap.put("createUserId", "创建者");
        headerMap.put("updateUserId", "更新者");
        headerMap.put("isDeleted", "逻辑删除");
        headerMap.put("companyIdDictMap.name", "学校");
        headerMap.put("sysUserIdDictMap.name", "系统用户ID");
        headerMap.put("openId", "openID");
        ExportUtil.doExport(resultList, headerMap, "student.xlsx");
    }

    /**
     * 查看指定学生对象详情。
     *
     * @param id 指定对象主键Id。
     * @return 应答结果对象，包含对象详情。
     */
    @SaCheckPermission("student.view")
    @GetMapping("/view")
    public ResponseResult<StudentVo> view(@RequestParam Long id) {
        Student student = studentService.getByIdWithRelation(id, MyRelationParam.full());
        if (student == null) {
            return ResponseResult.error(ErrorCodeEnum.DATA_NOT_EXIST);
        }
        StudentVo studentVo = MyModelUtil.copyTo(student, StudentVo.class);
        return ResponseResult.success(studentVo);
    }

    /**
     * 列出不与指定学生存在多对多关系的 [班级] 列表数据。通常用于查看添加新 [班级] 对象的候选列表。
     *
     * @param id 主表关联字段。
     * @param clazzDtoFilter [班级] 过滤对象。
     * @param orderParam 排序参数。
     * @param pageParam 分页参数。
     * @return 应答结果对象，返回符合条件的数据列表。
     */
    @SaCheckPermission("student.update")
    @PostMapping("/listNotInStudentClazz")
    public ResponseResult<MyPageData<ClazzVo>> listNotInStudentClazz(
            @MyRequestBody Long id,
            @MyRequestBody ClazzDto clazzDtoFilter,
            @MyRequestBody MyOrderParam orderParam,
            @MyRequestBody MyPageParam pageParam) {
        if (MyCommonUtil.isNotBlankOrNull(id) && !studentService.existId(id)) {
            return ResponseResult.error(ErrorCodeEnum.INVALID_RELATED_RECORD_ID);
        }
        if (pageParam != null) {
            PageMethod.startPage(pageParam.getPageNum(), pageParam.getPageSize(), pageParam.getCount());
        }
        Clazz filter = MyModelUtil.copyTo(clazzDtoFilter, Clazz.class);
        String orderBy = MyOrderParam.buildOrderBy(orderParam, Clazz.class);
        List<Clazz> clazzList =
                clazzService.getNotInClazzListByStudentId(id, filter, orderBy);
        return ResponseResult.success(MyPageUtil.makeResponseData(clazzList, ClazzVo.class));
    }

    /**
     * 列出与指定学生存在多对多关系的 [班级] 列表数据。
     *
     * @param id 主表关联字段。
     * @param clazzDtoFilter [班级] 过滤对象。
     * @param studentClazzDtoFilter 多对多关联表过滤对象。
     * @param orderParam 排序参数。
     * @param pageParam 分页参数。
     * @return 应答结果对象，返回符合条件的数据列表。
     */
    @SaCheckPermission("student.view")
    @PostMapping("/listStudentClazz")
    public ResponseResult<MyPageData<ClazzVo>> listStudentClazz(
            @MyRequestBody(required = true) Long id,
            @MyRequestBody ClazzDto clazzDtoFilter,
            @MyRequestBody StudentClazzDto studentClazzDtoFilter,
            @MyRequestBody MyOrderParam orderParam,
            @MyRequestBody MyPageParam pageParam) {
        if (!studentService.existId(id)) {
            return ResponseResult.error(ErrorCodeEnum.INVALID_RELATED_RECORD_ID);
        }
        if (pageParam != null) {
            PageMethod.startPage(pageParam.getPageNum(), pageParam.getPageSize(), pageParam.getCount());
        }
        Clazz filter = MyModelUtil.copyTo(clazzDtoFilter, Clazz.class);
        String orderBy = MyOrderParam.buildOrderBy(orderParam, Clazz.class);
        StudentClazz studentClazzFilter =
                MyModelUtil.copyTo(studentClazzDtoFilter, StudentClazz.class);
        List<Clazz> clazzList =
                clazzService.getClazzListByStudentId(id, filter, studentClazzFilter, orderBy);
        return ResponseResult.success(MyPageUtil.makeResponseData(clazzList, ClazzVo.class));
    }

    /**
     * 批量添加学生和 [班级] 对象的多对多关联关系数据。
     *
     * @param studentId 主表主键Id。
     * @param studentClazzDtoList 关联对象列表。
     * @return 应答结果对象。
     */
    @SaCheckPermission("student.update")
    @OperationLog(type = SysOperationLogType.ADD_M2M)
    @PostMapping("/addStudentClazz")
    public ResponseResult<Void> addStudentClazz(
            @MyRequestBody Long studentId,
            @MyRequestBody List<StudentClazzDto> studentClazzDtoList) {
        if (MyCommonUtil.existBlankArgument(studentId, studentClazzDtoList)) {
            return ResponseResult.error(ErrorCodeEnum.ARGUMENT_NULL_EXIST);
        }
        Set<Long> clazzIdSet =
                studentClazzDtoList.stream().map(StudentClazzDto::getClazzId).collect(Collectors.toSet());
        if (!studentService.existId(studentId)
                || !clazzService.existUniqueKeyList("id", clazzIdSet)) {
            return ResponseResult.error(ErrorCodeEnum.INVALID_RELATED_RECORD_ID);
        }
        List<StudentClazz> studentClazzList =
                MyModelUtil.copyCollectionTo(studentClazzDtoList, StudentClazz.class);
        studentService.addStudentClazzList(studentClazzList, studentId);
        return ResponseResult.success();
    }

    /**
     * 更新指定学生和指定 [班级] 的多对多关联数据。
     *
     * @param studentClazzDto 对多对中间表对象。
     * @return 应答结果对象。
     */
    @SaCheckPermission("student.update")
    @OperationLog(type = SysOperationLogType.UPDATE)
    @PostMapping("/updateStudentClazz")
    public ResponseResult<Void> updateStudentClazz(
            @MyRequestBody StudentClazzDto studentClazzDto) {
        String errorMessage = MyCommonUtil.getModelValidationError(studentClazzDto);
        if (errorMessage != null) {
            return ResponseResult.error(ErrorCodeEnum.DATA_VALIDATED_FAILED, errorMessage);
        }
        StudentClazz studentClazz = MyModelUtil.copyTo(studentClazzDto, StudentClazz.class);
        if (!studentService.updateStudentClazz(studentClazz)) {
            return ResponseResult.error(ErrorCodeEnum.DATA_NOT_EXIST);
        }
        return ResponseResult.success();
    }

    /**
     * 显示学生和指定 [班级] 的多对多关联详情数据。
     *
     * @param studentId 主表主键Id。
     * @param clazzId 从表主键Id。
     * @return 应答结果对象，包括中间表详情。
     */
    @SaCheckPermission("student.update")
    @GetMapping("/viewStudentClazz")
    public ResponseResult<StudentClazzVo> viewStudentClazz(
            @RequestParam Long studentId, @RequestParam Long clazzId) {
        StudentClazz studentClazz = studentService.getStudentClazz(studentId, clazzId);
        if (studentClazz == null) {
            return ResponseResult.error(ErrorCodeEnum.DATA_NOT_EXIST);
        }
        StudentClazzVo studentClazzVo = MyModelUtil.copyTo(studentClazz, StudentClazzVo.class);
        return ResponseResult.success(studentClazzVo);
    }

    /**
     * 移除指定学生和指定 [班级] 的多对多关联关系。
     *
     * @param studentId 主表主键Id。
     * @param clazzId 从表主键Id。
     * @return 应答结果对象。
     */
    @SaCheckPermission("student.update")
    @OperationLog(type = SysOperationLogType.DELETE_M2M)
    @PostMapping("/deleteStudentClazz")
    public ResponseResult<Void> deleteStudentClazz(
            @MyRequestBody Long studentId, @MyRequestBody Long clazzId) {
        if (MyCommonUtil.existBlankArgument(studentId, clazzId)) {
            return ResponseResult.error(ErrorCodeEnum.ARGUMENT_NULL_EXIST);
        }
        if (!studentService.removeStudentClazz(studentId, clazzId)) {
            return ResponseResult.error(ErrorCodeEnum.DATA_NOT_EXIST);
        }
        return ResponseResult.success();
    }

    /**
     * 批量移除指定学生和指定 [班级] 的多对多关联关系。
     *
     * @param studentId 主表主键Id。
     * @param clazzIdList 从表主键Id列表。
     * @return 应答结果对象。
     */
    @SaCheckPermission("student.update")
    @OperationLog(type = SysOperationLogType.DELETE_M2M_BATCH)
    @PostMapping("/deleteStudentClazzList")
    public ResponseResult<Void> deleteStudentClazzList(
            @MyRequestBody Long studentId, @MyRequestBody List<Long> clazzIdList) {
        if (MyCommonUtil.existBlankArgument(studentId, clazzIdList)) {
            return ResponseResult.error(ErrorCodeEnum.ARGUMENT_NULL_EXIST);
        }
        studentService.removeStudentClazzList(studentId, clazzIdList);
        return ResponseResult.success();
    }

    /**
     * 列出不与指定学生存在多对多关系的 [家长] 列表数据。通常用于查看添加新 [家长] 对象的候选列表。
     *
     * @param id 主表关联字段。
     * @param guardianDtoFilter [家长] 过滤对象。
     * @param orderParam 排序参数。
     * @param pageParam 分页参数。
     * @return 应答结果对象，返回符合条件的数据列表。
     */
    @SaCheckPermission("student.update")
    @PostMapping("/listNotInStudentGuardian")
    public ResponseResult<MyPageData<GuardianVo>> listNotInStudentGuardian(
            @MyRequestBody Long id,
            @MyRequestBody GuardianDto guardianDtoFilter,
            @MyRequestBody MyOrderParam orderParam,
            @MyRequestBody MyPageParam pageParam) {
        if (MyCommonUtil.isNotBlankOrNull(id) && !studentService.existId(id)) {
            return ResponseResult.error(ErrorCodeEnum.INVALID_RELATED_RECORD_ID);
        }
        if (pageParam != null) {
            PageMethod.startPage(pageParam.getPageNum(), pageParam.getPageSize(), pageParam.getCount());
        }
        Guardian filter = MyModelUtil.copyTo(guardianDtoFilter, Guardian.class);
        String orderBy = MyOrderParam.buildOrderBy(orderParam, Guardian.class);
        List<Guardian> guardianList =
                guardianService.getNotInGuardianListByStudentId(id, filter, orderBy);
        return ResponseResult.success(MyPageUtil.makeResponseData(guardianList, GuardianVo.class));
    }

    /**
     * 列出与指定学生存在多对多关系的 [家长] 列表数据。
     *
     * @param id 主表关联字段。
     * @param guardianDtoFilter [家长] 过滤对象。
     * @param studentGuardianDtoFilter 多对多关联表过滤对象。
     * @param orderParam 排序参数。
     * @param pageParam 分页参数。
     * @return 应答结果对象，返回符合条件的数据列表。
     */
    @SaCheckPermission("student.view")
    @PostMapping("/listStudentGuardian")
    public ResponseResult<MyPageData<GuardianVo>> listStudentGuardian(
            @MyRequestBody(required = true) Long id,
            @MyRequestBody GuardianDto guardianDtoFilter,
            @MyRequestBody StudentGuardianDto studentGuardianDtoFilter,
            @MyRequestBody MyOrderParam orderParam,
            @MyRequestBody MyPageParam pageParam) {
        if (!studentService.existId(id)) {
            return ResponseResult.error(ErrorCodeEnum.INVALID_RELATED_RECORD_ID);
        }
        if (pageParam != null) {
            PageMethod.startPage(pageParam.getPageNum(), pageParam.getPageSize(), pageParam.getCount());
        }
        Guardian filter = MyModelUtil.copyTo(guardianDtoFilter, Guardian.class);
        String orderBy = MyOrderParam.buildOrderBy(orderParam, Guardian.class);
        StudentGuardian studentGuardianFilter =
                MyModelUtil.copyTo(studentGuardianDtoFilter, StudentGuardian.class);
        List<Guardian> guardianList =
                guardianService.getGuardianListByStudentId(id, filter, studentGuardianFilter, orderBy);
        return ResponseResult.success(MyPageUtil.makeResponseData(guardianList, GuardianVo.class));
    }

    /**
     * 批量添加学生和 [家长] 对象的多对多关联关系数据。
     *
     * @param studentId 主表主键Id。
     * @param studentGuardianDtoList 关联对象列表。
     * @return 应答结果对象。
     */
    @SaCheckPermission("student.update")
    @OperationLog(type = SysOperationLogType.ADD_M2M)
    @PostMapping("/addStudentGuardian")
    public ResponseResult<Void> addStudentGuardian(
            @MyRequestBody Long studentId,
            @MyRequestBody List<StudentGuardianDto> studentGuardianDtoList) {
        if (MyCommonUtil.existBlankArgument(studentId, studentGuardianDtoList)) {
            return ResponseResult.error(ErrorCodeEnum.ARGUMENT_NULL_EXIST);
        }
        Set<Long> guardianIdSet =
                studentGuardianDtoList.stream().map(StudentGuardianDto::getGuardianId).collect(Collectors.toSet());
        if (!studentService.existId(studentId)
                || !guardianService.existUniqueKeyList("id", guardianIdSet)) {
            return ResponseResult.error(ErrorCodeEnum.INVALID_RELATED_RECORD_ID);
        }
        List<StudentGuardian> studentGuardianList =
                MyModelUtil.copyCollectionTo(studentGuardianDtoList, StudentGuardian.class);
        studentService.addStudentGuardianList(studentGuardianList, studentId);
        return ResponseResult.success();
    }

    /**
     * 更新指定学生和指定 [家长] 的多对多关联数据。
     *
     * @param studentGuardianDto 对多对中间表对象。
     * @return 应答结果对象。
     */
    @SaCheckPermission("student.update")
    @OperationLog(type = SysOperationLogType.UPDATE)
    @PostMapping("/updateStudentGuardian")
    public ResponseResult<Void> updateStudentGuardian(
            @MyRequestBody StudentGuardianDto studentGuardianDto) {
        String errorMessage = MyCommonUtil.getModelValidationError(studentGuardianDto);
        if (errorMessage != null) {
            return ResponseResult.error(ErrorCodeEnum.DATA_VALIDATED_FAILED, errorMessage);
        }
        StudentGuardian studentGuardian = MyModelUtil.copyTo(studentGuardianDto, StudentGuardian.class);
        if (!studentService.updateStudentGuardian(studentGuardian)) {
            return ResponseResult.error(ErrorCodeEnum.DATA_NOT_EXIST);
        }
        return ResponseResult.success();
    }

    /**
     * 显示学生和指定 [家长] 的多对多关联详情数据。
     *
     * @param studentId 主表主键Id。
     * @param guardianId 从表主键Id。
     * @return 应答结果对象，包括中间表详情。
     */
    @SaCheckPermission("student.update")
    @GetMapping("/viewStudentGuardian")
    public ResponseResult<StudentGuardianVo> viewStudentGuardian(
            @RequestParam Long studentId, @RequestParam Long guardianId) {
        StudentGuardian studentGuardian = studentService.getStudentGuardian(studentId, guardianId);
        if (studentGuardian == null) {
            return ResponseResult.error(ErrorCodeEnum.DATA_NOT_EXIST);
        }
        StudentGuardianVo studentGuardianVo = MyModelUtil.copyTo(studentGuardian, StudentGuardianVo.class);
        return ResponseResult.success(studentGuardianVo);
    }

    /**
     * 移除指定学生和指定 [家长] 的多对多关联关系。
     *
     * @param studentId 主表主键Id。
     * @param guardianId 从表主键Id。
     * @return 应答结果对象。
     */
    @SaCheckPermission("student.update")
    @OperationLog(type = SysOperationLogType.DELETE_M2M)
    @PostMapping("/deleteStudentGuardian")
    public ResponseResult<Void> deleteStudentGuardian(
            @MyRequestBody Long studentId, @MyRequestBody Long guardianId) {
        if (MyCommonUtil.existBlankArgument(studentId, guardianId)) {
            return ResponseResult.error(ErrorCodeEnum.ARGUMENT_NULL_EXIST);
        }
        if (!studentService.removeStudentGuardian(studentId, guardianId)) {
            return ResponseResult.error(ErrorCodeEnum.DATA_NOT_EXIST);
        }
        return ResponseResult.success();
    }

    /**
     * 批量移除指定学生和指定 [家长] 的多对多关联关系。
     *
     * @param studentId 主表主键Id。
     * @param guardianIdList 从表主键Id列表。
     * @return 应答结果对象。
     */
    @SaCheckPermission("student.update")
    @OperationLog(type = SysOperationLogType.DELETE_M2M_BATCH)
    @PostMapping("/deleteStudentGuardianList")
    public ResponseResult<Void> deleteStudentGuardianList(
            @MyRequestBody Long studentId, @MyRequestBody List<Long> guardianIdList) {
        if (MyCommonUtil.existBlankArgument(studentId, guardianIdList)) {
            return ResponseResult.error(ErrorCodeEnum.ARGUMENT_NULL_EXIST);
        }
        studentService.removeStudentGuardianList(studentId, guardianIdList);
        return ResponseResult.success();
    }

    /**
     * 附件文件下载。
     * 这里将图片和其他类型的附件文件放到不同的父目录下，主要为了便于今后图片文件的迁移。
     *
     * @param id 附件所在记录的主键Id。
     * @param fieldName 附件所属的字段名。
     * @param filename  文件名。如果没有提供该参数，就从当前记录的指定字段中读取。
     * @param asImage   下载文件是否为图片。
     * @param response  Http 应答对象。
     */
    @SaCheckPermission("student.view")
    @OperationLog(type = SysOperationLogType.DOWNLOAD, saveResponse = false)
    @GetMapping("/download")
    public void download(
            @RequestParam(required = false) Long id,
            @RequestParam String fieldName,
            @RequestParam String filename,
            @RequestParam Boolean asImage,
            HttpServletResponse response) {
        if (MyCommonUtil.existBlankArgument(fieldName, filename, asImage)) {
            response.setStatus(HttpServletResponse.SC_BAD_REQUEST);
            return;
        }
        // 使用try来捕获异常，是为了保证一旦出现异常可以返回500的错误状态，便于调试。
        // 否则有可能给前端返回的是200的错误码。
        try {
            // 如果请求参数中没有包含主键Id，就判断该文件是否为当前session上传的。
            if (id == null) {
                if (!cacheHelper.existSessionUploadFile(filename)) {
                    ResponseResult.output(HttpServletResponse.SC_FORBIDDEN);
                    return;
                }
            } else {
                Student student = studentService.getById(id);
                if (student == null) {
                    ResponseResult.output(HttpServletResponse.SC_NOT_FOUND);
                    return;
                }
                String fieldJsonData = (String) ReflectUtil.getFieldValue(student, fieldName);
                if (fieldJsonData == null && !cacheHelper.existSessionUploadFile(filename)) {
                    ResponseResult.output(HttpServletResponse.SC_BAD_REQUEST);
                    return;
                }
                if (!BaseUpDownloader.containFile(fieldJsonData, filename)
                        && !cacheHelper.existSessionUploadFile(filename)) {
                    ResponseResult.output(HttpServletResponse.SC_FORBIDDEN);
                    return;
                }
            }
            UploadStoreInfo storeInfo = MyModelUtil.getUploadStoreInfo(Student.class, fieldName);
            if (!storeInfo.isSupportUpload()) {
                ResponseResult.output(HttpServletResponse.SC_NOT_IMPLEMENTED,
                        ResponseResult.error(ErrorCodeEnum.INVALID_UPLOAD_FIELD));
                return;
            }
            BaseUpDownloader upDownloader = upDownloaderFactory.get(storeInfo.getStoreType());
            upDownloader.doDownload(appConfig.getUploadFileBaseDir(),
                    Student.class.getSimpleName(), fieldName, filename, asImage, response);
        } catch (Exception e) {
            response.setStatus(HttpServletResponse.SC_INTERNAL_SERVER_ERROR);
            log.error(e.getMessage(), e);
        }
    }

    /**
     * 文件上传操作。
     *
     * @param fieldName  上传文件名。
     * @param asImage    是否作为图片上传。如果是图片，今后下载的时候无需权限验证。否则就是附件上传，下载时需要权限验证。
     * @param uploadFile 上传文件对象。
     */
    @SaCheckPermission("student.view")
    @OperationLog(type = SysOperationLogType.UPLOAD, saveResponse = false)
    @PostMapping("/upload")
    public void upload(
            @RequestParam String fieldName,
            @RequestParam Boolean asImage,
            @RequestParam("uploadFile") MultipartFile uploadFile) throws IOException {
        UploadStoreInfo storeInfo = MyModelUtil.getUploadStoreInfo(Student.class, fieldName);
        // 这里就会判断参数中指定的字段，是否支持上传操作。
        if (!storeInfo.isSupportUpload()) {
            ResponseResult.output(HttpServletResponse.SC_FORBIDDEN,
                    ResponseResult.error(ErrorCodeEnum.INVALID_UPLOAD_FIELD));
            return;
        }
        // 根据字段注解中的存储类型，通过工厂方法获取匹配的上传下载实现类，从而解耦。
        BaseUpDownloader upDownloader = upDownloaderFactory.get(storeInfo.getStoreType());
        UploadResponseInfo responseInfo = upDownloader.doUpload(null,
                appConfig.getUploadFileBaseDir(), Student.class.getSimpleName(), fieldName, asImage, uploadFile);
        if (Boolean.TRUE.equals(responseInfo.getUploadFailed())) {
            ResponseResult.output(HttpServletResponse.SC_FORBIDDEN,
                    ResponseResult.error(ErrorCodeEnum.UPLOAD_FAILED, responseInfo.getErrorMessage()));
            return;
        }
        cacheHelper.putSessionUploadFile(responseInfo.getFilename());
        ResponseResult.output(ResponseResult.success(responseInfo));
    }

    /**
     * 以字典形式返回全部学生数据集合。字典的键值为[id, name]。
     * 白名单接口，登录用户均可访问。
     *
     * @param filter 过滤对象。
     * @return 应答结果对象，包含的数据为 List<Map<String, String>>，map中包含两条记录，key的值分别是id和name，value对应具体数据。
     */
    @GetMapping("/listDict")
    public ResponseResult<List<Map<String, Object>>> listDict(@ParameterObject StudentDto filter) {
        List<Student> resultList =
                studentService.getListByFilter(MyModelUtil.copyTo(filter, Student.class));
        return ResponseResult.success(MyCommonUtil.toDictDataList(
                resultList, Student::getId, Student::getName));
    }

    /**
     * 根据字典Id集合，获取查询后的字典数据。
     *
     * @param dictIds 字典Id集合。
     * @return 应答结果对象，包含字典形式的数据集合。
     */
    @GetMapping("/listDictByIds")
    public ResponseResult<List<Map<String, Object>>> listDictByIds(@RequestParam List<Long> dictIds) {
        List<Student> resultList = studentService.getInList(new HashSet<>(dictIds));
        return ResponseResult.success(MyCommonUtil.toDictDataList(
                resultList, Student::getId, Student::getName));
    }

    private ResponseResult<Void> doDelete(Long id) {
        String errorMessage;
        // 验证关联Id的数据合法性
        Student originalStudent = studentService.getById(id);
        if (originalStudent == null) {
            // NOTE: 修改下面方括号中的话述
            errorMessage = "数据验证失败，当前 [对象] 并不存在，请刷新后重试！";
            return ResponseResult.error(ErrorCodeEnum.DATA_NOT_EXIST, errorMessage);
        }
        if (!studentService.remove(id)) {
            errorMessage = "数据操作失败，删除的对象不存在，请刷新后重试！";
            return ResponseResult.error(ErrorCodeEnum.DATA_NOT_EXIST, errorMessage);
        }
        return ResponseResult.success();
    }
}
